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ABSTRACT 


This  report  describes  a tutorial  for  introducing  novice 
users  to  a collection  of  computer  programs  which  support  inter- 
personal communication.  The  tutorial  is  designed  to  reduce 
the  apparent  complexity  of  the  multiple  command  languages 
involved.  The  instructional  strategy  used  provides  a 
model  for  other  training  situations  in  which  a collection  of 
computer  programs  must  be  taught  simultaneously. 

The  tutorial  first  presents  concepts  v/hich  facilitate 
understanding  of  the  various  command  languages.  This  is 
followed  by  a series  of  exercises  leading  up  to  the  new  user's 
performance  of  a sample  task  involving  a limited  subset  of 
all  commands.  The  tutor  monitors  the  new  user's  progress  and 
offers  advice.  This  approach  puts  the  new  user  in  an  active, 
proble:  -solving  role  from  the  beginning. 

The  collection  of  programs  described  in  this  tutorial  is 
called  the  Tenex  Electronic  Notebook-Conference  (TEN-C) 

System.  Included  in  this  "system"  are  the  XED  text  editor, 
the  MSG  message  handling  program,  the  ZCONFER  conf erenciiig 
program  (a  modification  of  FORUM  5) . These  programs  operate 
under  the  TENEX  executive  on  the  PDF-10  computers  at  the 
USC/Information  Sciences  Institute. 

This  description  of  the  tutorial  should  provide  the  reader 
with  a useful  introduction  to  the  Electronic  Notebook  and 
Conferencing  capabilities  offered  by  these  programs.  This 
document  is  not  intended  to  fully  substitute  for  live 
presentation  of  the  training  of  the  complete  docv”'-'-ntation 
of  the  individual  progrcims. 
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PREF/tCE 


Thi-.  report  it  intended  for  those  who  train  new  uters  of  the  computer  programs 
described  herein.  It  it  not  a training  manual f 

This  report  describes  a tutorial  for  introducing  novice  users  to  a collection  of 
computer  programs  which  support  interpersonal  communication.  The  tutorial  is 
designed  to  reduce  the  apparent  complexity  of  the  multiple  command  languages 
involved.  The  inst'uctional  strategy  used  provides  a model  fo-  other  training  situations 
in  which  a collection  of  computer  programs  must  be  taught  simultaneously. 

The  tutorial  first  presents  concept?  »•  hich  facilitate  understanding  of  the  various 
command  languages.  Th  c is  followed  jy  a series  of  exercises  leading  up  to  the  new 
user’s  performance  of  a sample  task  nvc'ving  a limited  subset  of  all  commands.  The 
tutor  monitors  the  new  user's  progres;  and  offers  advice.  This  approach  puts  the  new 
user  in  an  active,  prcblem-soiving  role  fom  the  beginning. 

The  collection  of  programs  described  in  this  tutorial  is  called  the  Tenex  Electronic 
Notebook-Conference  (TEN-C)  System,  included  in  this  "system"  are  the  XED  text 
editor,  the  MSG  message  handling  program,  and  the  ZCONFER  conferencing  program. 
These  programs  operate  under  the  TENEX  executive  c.i  several  PDP-10  computers  at 
the  USC/Information  Sciences  Institute. 

This  description  of  the  tutorial  should  provide  the  reader  with  a useful  introduction 
to  the  electronic  notebook  and  conferencing  capabilities  offered  by  these  programs. 

The  students  for  whom  this  tutorial  was  designed  have  a basic  familiarity  with  online 
computers  (particularly  with  the  PLATO  System)  and  have  agreed  to  participate  in  an 
extended  conference.  The  goals  of  the  tutorial  are  for  new  conference  participants  to 
become  self-sufficient  and  eventually  sophisticated  users  of  the  TEN-C  capabilities. 
This  tutorial  attempts  to  provic*  a solid  introduction  from  which  users  would  be  able  lo 
keep  on  learning  about  the  va'-ious  programs  on  their  own.  This  tutorial  supplements, 
rather  than  substitutes  for  complete  written  documentation  and  on-line  "Help"  features 
of  each  of  the  TEN-C  programs. 

Several  additional  disclaimers  should  be  made  at  the  outset.  First,  these  programs 
were  not  created  by  this  autho.v  The  ZCONFER  program,  for  example,  is  a modified 
version  of  the  FORUM  5 program  developed  by  Institute  for  tto  Future  (Vallee,  Lipinski 
and  Miller,  1974).  Readers  who  have  used  FORUM  5 will  note  in  ZCONFER  several  minor 
changes  in  the  conventions  of  the  user  language. 


Precei'ine  page  blank 


Second,  these  programs  were  not  designed  to  be  used  together.  They  a-e 
remarkably  consistent  in  convention,  given  the  fact  that  they  are  being  combined  nd  hoc 
for  support  of  electronic  notebook  and  conferencing  activities. 

Third,  because  these  programs  are  frequently  impro' ed,  no  daim  is  made  that 
conventions  and  commands  will  remain  fixed  over  time  a‘  new  capabilities  are  added. 
This  document  is  not  an  official  user’s  manual,  bi*  rather  a progress  report.  Each  of 
the  programs  is  docuimented  with  an  on-line  Help  feature. 

Finally,  the  TEN-C  System  is  admittedly  ad  hoc  and  in  need  of  improvement. 
Despite  the  few  inconveniences  and  inconsistencies,  the  TEN-C  System  is  a powerful  and 
effective  means  for  computer-based  teleconferencing. 


ACKNOWLEDGMENTS:  I am  indebted  to  Bill  Mann,  Don  Oestreicher,  Ron  Tugender,  Rob 
Stotz,  Dave  Crocker,  Alex  Archbold  and  Rudy  Bretz  for  comments  on  an  earlier  draft  of 
this  document. 
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/).  iM  Koni  crinx 


I'hc  l'('nri  r.lrrtrniiir  Siilrhitok  (.onli'n'nif  II.S-l. 
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Figure  1,  Relative  Strengths  and  Wear.ne  ses  of  TEtJ-C  rVo;'i  aim. 


As  you  can  see  from  figure  1,  any  of  the  progtams  vttulil  -e  used  b,  ih.idf  to  peiforrn 
text  preparation,  attribution,  stoi  age  and  istiie  ui'.  We  h.i  e loinn]  ,,t  ISI  that  foi  any 
extensive  conferencing  or  electionic  noteljoov  acti  /ih^.  it  >s  ingni,'  ues.i -ible  to  ust>  ail 
three  programs,  rno/mg  qjisKly  as-iong  thetv  to  peitoim  tasr.s  n etlec  ti\ nl> , 
Consider  the  fotiovnng  scenario. 


A Srrnnrin  of  /7‘,’,V-(,'  ,]i  liiiiy 

You  base  been  av-ay  hoiti  ,Oui  otfice  for  a - .icatioa  You  letmti  to  fiiuJ  a 

fev;  bills  and  per  ot'al  letters  on  ,our  «esK  Tht'O  are  no  phoii!-  h;.  , .,i  ;e',  or  office 
memos  m sight.  You  tu-ui  on  ^our  coi  ^ itei  teiiMinal,  lo.cm  to  tht-  ITMIX  eveuitive 
program  on  the  compi.tei  and  initiate  the  N/SC  pi():;i.im,  This  pio;;i  ,iin  .autohiatic  ally 
"reads"  your  online  "file”  of  r,,essages  and  notes  ,ill  nc>  ,v  messa;-,n.,  leu’u'ed  fiom  otlier 
locattons  on  the  nation-v^ide  net.vorr.  to  jxlncii  ,oui  lorai  romprrtcM  r,  ( onnnc  teri.  For 
each  new  message,  the  MSG  piO'iam  prints  out  the  date  and  time  recc'i  .f  d,  tiie  ■■end'i 
and  a brief  description  of  the  s'jpjed.  You  scan  thi-  list  of  "inessage  hi.Mdcvs",  note 
two  of  potential  importance,  and  ask  the  program  to  print  ttiose  two  mess, ages  on  the 
screen, 
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The  fir‘il  tne'j-.tip.e  is  from  one  of  ,Oui  coile.i'.ue-.,  ^nnounc m;;  the  ccinplplion  of  a 
draft  of  hi‘j  ch.iptLr  for  a rcpO''!  ^Oj  arc  prepat  am.  Since  he  //Oi  K'  in  another  branch 
of  coer  oraamjat  on  .ocated  25  '■niter.  a*ia,,  he  requent',  that  yOu  r.imply  read  and 
comri,eiit  On  the  online  erciori  of  ttie  chapter.  Me  'rpeufiec.  the  "filena  nc"  which  this 
chapter  has,  and  tiotes  that  it  is  in  nis  "direi. tor  y"  on  the  san.e  cotnputer. 

The  second  mes'  age  announrt.'s  a iMeetnvj  scheduled  for  1 hour  from  now  to  discuss 
the  progress  on  the  report  witti  yOur  super  /enr  You  imnir'diati.'ly  respond  to  your 
supervisor's  message  by  sending  ner  ore  agieeing  to  t*'.e  meeting  time. 

You  next  telephone  one  of  yjur  colleagues,  Tom,  who  doesn't  ha/e  his  own  terminal. 
You  check  on  the  status  of  his  report  cliapter.  He  agrees  to  get  a copy  to  you  within  a 
hall  -an-heur. 

You  has'e  /i!ty-fise  minutes  to  new  Joe's  cliapter  and  prepaie  for  the  briefing. 
(Your  own  ciiapters  are.  of  course,  aitcady  coinpieted.)  Joe's  chapte:  is  only  fr/e  pages 
long  ,0  you  don't  hofber  to  get  a papc*r  printout  from  the  printi?r,  which  is  located 
upstairs.  Instead,  you  go  from  the  MSG  program  into  a test  editing  piogr.im  called  XED. 
This  IS  done  Ijy  typing  one  letter,  "y"!  You  "read  m"  the  file  containing  joe's  chapter  and 
"view"  a screen-full  of  Imps  on  yc.ur  terminai.  As  you  bro'wse  through,  the  chapter,  one 
screen-full  at  a time,  you  find  several  statements  winch  must  be  le.'ised.  Using  the  edit 
corrmiands  yOU  alter  the  text  as  needed.  After  viewing  the  entire  hie  containing  Joe’s 
chapter,  you  decide  to  add  a few  paragraplis,  to  provide  continuity  with  your  own 
chapter.  You  review  the  entire  file.  Satisfied,  you  eyil  from  the  editor,  automatically 
creat.ng  a now  "version"  of  the  file  m your  fiie  "directory",  (joe's  version  is  still  in  his 
directory,  unaltered.) 

Since  you  initiated  the  XED  program  from  the  MSG  program,  upon  quitting  XED  you 
return  automatically  to  MScT  You  now  send  a rnessage  to  Joe,  informing  him  of  the 
changes,  the  new  version  of  his  chapter  in  your  directory,  and  the  meeting  (which  tie 
need  not  attend)  Smee  Joe  works  different  hours  tlian  you,  iie  probably  won't  get  the 
message  until  later  (unless,  of  course,  he  has  a portalile  termirial  at  home.) 

About  this  time  you  rccer/e  .i  message  from  Torn.  MSG  notifies  you  by  printing  out 
the  header  of  tins  new  message.  You  type  the  message  and  learn  that  Tom's  chapter  is 
completed  and  a listing  is  waitmg  (or  you  at  lice  Iniep.'inler  upstairs.  You  ‘.end  him  a 
message  (since  you  don't  know  A/hcie  he  is  using  llie  terminal),  thanking  him. 

You  now  quit  the  MSG  progr.irn,  This  leaves  you  in  the  TENEX  eyccutive  program. 
Us’ng  the  "list"  command,  yOu  print  out  copies  of  Joe's  and  ynur  chapter  on  'i'e 
lineprinter,  you  call  your  secretarv  and  ask  him  to  pick  up  the  printouts  for  you. 

You  nov.'  have  AO  minutes  to  prepare  for  the  briefing.  Since  membei  s of  your 
project  team  have  been  convers  ng  daily  while  vou  were  aw'ay,  you  want  to  catch  up  on 
progress  and  decisions  relevant  ti  your  report. 
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Fortunately,  ^ome  of  tlieir  dir.cur.oiono  took  ,jiace  in  the  conferencing  program  c;  ‘ 
that  a transcript  woulcf  exist  for  later  reference.  You  mitmte  the  ronferencmu  program 
by  typing  ZCONFER  ancf  "jom"  the  coiiference  titled  This  Mmiih's  I'rojvci  Xoirhook. 
This  conference  has  only  two  topics;  "the  progress  report"  and  "plans  for  future 
research."  You  go  to  the  first  topic.  All  "entries"  by  other  "participants"  that  are  new 
since  you  were  last  in  this  topic  of  the  conference  are  printed  out  on  your  screen,  one 
pageful  at  a time.  You  read  them,  add  an  "entry"  responding  to  se.'eral  questions 
raised  by  Tom,  and  add  an  entry  noting  that  you  ha''e  copies  of  Joe’s,  Torn’s  and  your 
chapters  which  you  are  taking  to  a briefing  for  your  supervisor.  No  one  else  is 
currently  using  the  conference  so  yOur  entries  are  just  stored  away  under  topic  one. 

Your  secretary  brings  in  the  listings  and  you  note  that  the  meeting  is  scheduled  to 
begin  in  only  30  rrnnutes.  You  read  through  the  printouts,  making  notes  in  the  niargins. 
Out  of  the  corner  of  your  eye,  you  note  activity  on  your  terminal  scieen.  Joe  has 
joined  the  conference.  He  sends  you  a "private  message"  m ZCONFER,  thanking  you  for 
the  improvements  to  his  chapte  . He  has  received  your  message  and  has  read  the 
version  of  his  cnapter  which  you  created.  This  private  message  is  not  stored  in  the 
permanent  transcript  of  the  conference  Only  public  messages  are  labelled  and  stored. 
You  enter  a (public)  message  indicating  that  you  will  use  ZCONFER  at  3:00  p.m.  that  Jay 
to  report  on  (and  discuss)  the  results  of  the  briefing.  Joe  responds  with  a priv;  :e 
message  "OK,  good  luck!"  and  leaves  the  conference.  You  quit  the  conference  also. 

You  next  use  the  editor  to  compose  an  announrement  of  the  3:00  p.m.  ZCONFER 
discussion  and  "send"  it  to  all  members  of  youc  project  with  the  SNDM5G  command  in 
XEO.  You  quit  XEO  logout  of  the  system,  and  spend  the  next  15  minutes  reading 
Science  magazine  before  going  to  your  briefing. 


This  scenario  represents  typical  use  of  TEN-C  by  an  experienced  user.  All  those 
activities  could  have  occurred  in  less  than  45  minutes.  Note  the  variety  of 

communication  media  used.  MSG  was  used  to  send  rinnouncements,  hke  'riail.  It  is 
assumed,  on  this  project,  that  everyone  checks  his  or  her  mail  periodically  when  m the 
office.  The  editor  XEO  was  used  to  compose  and  e/en  to  new  any  text  moie  than  a 
few  lines  in  length.  Lengthy  messages  were  sent  directly  from  the  editor.  The 
specially-structured  message  fiie  was  not  viewed  with  XEO,  but  with  the 

specially-designed  MSG  program,  which  keeps  track  of  which  messages  are  old-new. 
viewed-not  viewed,  and  permits  selective  typing  of  messages.  The  ZCONFER  program 
was  used  for  con'/ersation  and  reporting  of  a permanent  nature.  The  telephone  was 
used  whenever  possible  and  reasonable.  The  briefing  to  the  supervisor  involved 
face-to-face  meeting  with  paper  printouts  that  could  be  quickly  brov;sed  through  and 
marked  up. 

Clearly,  no  One  m.ode  of  communication  and  no  one  prograrn  was  capable  of  handling 
all  of  these  information  processing  activities  with  such  ease  and  efficiency.  Knowledge 
and  use  of  less  than  a dozen  different  computer  commands  were  necessary  to  carry  out 
the  entire  45  minute  work  session.  This  tutorial  is  designed  to  prepare  a new  user  to 
do  all  of  the  tasks  described  in  the  above  scenario. 
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The  Krohnion  of  TI'.S-C. 

ri'iO  FORUM  conferoncing  program  has  been  m tse  at  151  since  July  of  1973.  It  is 
being  used  as  a project  notebook  for  several  ARPA-sponsoied  research  efforts,  as  a 
real-time  teleconference  when  staff  are  out  of  town  at  planning  meetiiigs  and  need  to 
get  periodic  advice  from  their  colleagues  back  at  ISI,  and  as  a transpoi  tation  substitute 
in  a six-month  long  research  seminar. 

In  many  cases,  participants  want  to  submit  lengthy,  carefully  planned  entries  to  the 
conference.  Especially  in  report  preparation,  several  drafts  of  a section  may  be 
prepared  and  circulated  before  bemg  submitted  to  the  conference  transcript.  Once  an 
entry  is  submitted  to  ZCONFFR  (or  FORUM  5)  it  cafinot  be  ecldted  or  deleted.  Careless 
entry  sometimes  leads  to  a long-lasting  embarrassment.  For  these  reasons,  we  have 
found  that  use  of  a text  editor  is  very  important.  Participants  in  ail  ISI  conferences  are 
encouraged  to  prepare  any  lengthy  entries  or  position  papers  m the  text  editor  mode  of 
XED  so  that  they  can  be  carefully  checked  and  perhaps  levised  before  submission  to 
the  transcript. 

At  the  other  extreme,  announcements  which  must  bo  lead  and  perhaps  responded  to 
by  all  participants  seem  to  be  best  handled  by  a mail-type  pro, gram  such  as  MSG,  rather 
than  by  the  pnv.3te  rriessage  capability  of  ZCOWFER.  The  MSG  program  facilitates 
answering,  forwarding  and  sorting  of  messages  into  personal  online  files  for  storage. 
Furthermore,  MSG  has  a command  to  switch  into  XED  mode.  XED  has  a coirmiand  to 
"send  the  current  file  as  a message.”  These  three  programs:  ZCOMFlR,  XED  and  MSG 

work  together  to  provide  a rich  electronic  notebook  and  conferoncing  support  system 

[!]■ 


The  T£N-C  System  is  currently  operating  on  several  PDP-10  computers  at  the 
University  of  Southern  California’s  Information  Sciences  instdute.  Use  of  TEN-C  is 
limited  to  those  with  regular  accounts  on  the  USC/ISI  computers.  From  time  to  time, 
teleconfei  ence  workshops  may  be  arranged  as  a part  of  research  sponsored  by  the 
Advanced  Research  Projects  Agency  (ARPA).  Invited  participants  may  be  authorized  to 
use  guest  accounts  for  such  TEN-C  activity. 

ARPA-sponson?d  researchers  who  are  seriously  interested  in  using  TEN-C  should 
contact  Dr,  William  C.  Mann  at  ISl.  There  is  currently  no  funded  supoort  for  the  TEN-C 
system,  per  se.  Its  existence  and  the  tutorial  described  in  tliis  document  grew  out  of 
internal  need  and  daily  use  by  about  a dozen  resea.'chers  at  1ST 

A commercially  available  service  comparable  to  TEN-C  is  offered  by  the  Institute  fc  r 
the  Future.  Contact  Jacques  "allee  at  27A0  Sand  Hill  Road,  Menlo  Park,  Califort.ia 
SA025,  for  further  information  on  the  FORUM  program. 
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Tho  Nr,'fi  for  thin  Tntorinl 

The  various  programs  which  make  up  the  Tenex  Electronic  Notebook  Conference 
(TEN-C)  were  designed  to  be  used  separate!/,  Their  user  manuals  present  therti  as 
separate  programs.  Togefier,  they  contain  just  O'/er  100  commands  in  their  user 
languages.  Even  with  a well-thought  out  user  manual  for  each  program,  this  can  pose 
an  overwhelming  learning  situation  tor  a new  user  One  need  for  this  tutorial  v/as  to 
reduce  the  apparent  complexity  of  this  collection  of  programs  down  to  a level  where  a 
few  hours  of  training  would  leave  the  new  user  confident  and  able  to  learn  the 
remaining  command  capabilities  at  Ins  or  her  own  pace, 

A second  purpose  for  the  tutorial  was  to  permit  efficient  and  effective  on-site 
training  of  new  TEN-C  system  usei  s for  a teleconfei  ence  that  was  being  planned  as 
part  of  an  ARPA  sponsored  research  effort.  Tins  training  was  to  involve  ore  or  two 
users  at  each  of  a dozen  sites  around  the  United  States.  We  decided  that  a written 
user  manual  was  not  likely  to  be  successful  and  that  the  online  tutorial  features  of  the 
separate  prograns  were  not  sufficient  The  students  for  whom  thiis  tutorial  was 
designed  h.ad  a b/.sic  familiarity  with  compuiers  (the  PLATO  •r'/stem  in  particu'ar).  The 
goals  of  the  tuiorial  were  for  new  conference  participants  to  become  self-suf.iaent  and 
eventually  sophisticated  users  of  Ine  TEN-C  capabilities. 


[1]  The  XEO  te)t  editor  was  designed  and  programmed  by  Dun, 'Id  Oestreicner  and 
Ronald  Tuger'der  at  the  University  of  Southei  n California/lnfoi  mation  Sc  iences  institute 
(ISI).  'he  MSG  Message  handling  piogram  was  developed  at  ISI  by  John  Vittal.  It  is  an 
extended  version  of  the  BANANARO  program,  created  by  Marty  Yonke  at  ISI.  The  idea 
for  MSG  c„sie  from  »arly  work  done  by  Barry  Wesseler  .it  Bolt,  Bei  anek  and  Kjwinan, 
In,  ^CONFER  is  a version  of  the  FORUM  5 conferencing  program  developed  by  the 
Institute  fc-  the  Future,  to  whirl'  gee  Richardson,  at  ISI,  has  made  a few  modifications. 
The  I’ENEX  Executive  program  fo''  use  on  Digital  Equipment  Corporation's  PDP-lvT 
computers  is  available  from  Bolt,  Bei  anek  and  Newinan,  Inc. 

Complete  users  rr.aruals  for  po*h  XEO  and  MSG  are  available  online  as  the  orog’ ams  are 
used.  These  programs  are  periodically  revised,  so  readers  should  chock  bcfoie  taking 
the  summaries  and  discussion  witlrin  this  tutorial  as  gospel  truth. 

Complete  understanding  of  ZCONFER  is  best  obtained  from  the  "Forum  User  Guide" 
which  is  included  as  an  appendix  to  the  report  b>  Vallee,  Lipmski  ana  Miller  (1974). 
titled  "Group  Communication  Through  Coniputerr,  Volume  1:  Design  Use  cf  the 

FORUM  System".  That  report  also  provides  an  excellent  background  on  and  several 
exam.ples  of  teleconferencing  with  tire  FORUM-nke  (ZC(JNFER)  portion  of  tire  TEN-C 
System. 

The  TENEX  Executive  Language  documentation  is  available  from  Bolt,  Beranek  and 
Newman,  Inc.  (Myer  and  Barnaby,  1973  and  Burchfiel,  oj.  n/.,  1975.) 

A Brief  summary  of  the  ZCONFER  command  is  included  as  an  appendix  to  this  document. 
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n.  h\STKUCTIOy/]l.  ni'SIGS  stkatkcv 

The  instructional  design  strategy  has  the  following  components; 

1.  Idriuifirrilioii  of  the  imjiortnnl  rnnuiioitalilios  and  diffrrrnrrx  ainniifr  the 
programs.  A conceptual  structure  is  presented  in  'which  the  prograuiS  are  treated  as 
"modes"  within  a single  O'v'ei  ill  system,  TEN-C.  Conventions  'which  hold  for  all  modes 
are  presented  first,  with  exceptions  and  unique  functions  presented  later. 

Pri'iinrnlinn  of  the  student  to  understand  the  documentation  proridc  l online  for 
each  program.  Conventions  used  in  online  help  facilities  are  introduced  so  that  the  new 
user  w'll  feel  comfortable  in  using  those  facilities  to  keep  on  learning  about  FEN-C  after 
the  tutorial.  Eaiphasis  is  placed  on  the  introductory  scope  of  the  tutorial,  and  the 
importance  of  exploration  and  learning  new  command  features  ns  the  need  arises  in  use 
of  TEN-C. 

.'i.  Kednetion  of  romplriity  to  a innnnaeahle  level.  The  structure  of  TEN-C, 
conceptually,  is  hiera'chical.  The  number  of  conm'mnd  modes  and  the  number  of  options 
within  each  mode  are  minimized.  The  /Ihhreiinted  liter  Manual  encourages  students  to 
recognize  the  iiriportance  of  being  in  one  mode  rather  than  another. 

We  have  found  that  many  frustrations  0*  new  users  are  due  to  repeated  attempts  to 
execute  a command  in  the  wrong  mode. 

V'lth  a complex  time  sharing  system  such  as  TENEX,  it  is  not  safe  fo  assume  that  a 
cookbook  procedure  will  suffice  to  keep  users  out  of  trouble.  This  tutorial  attempts  to 
introduce  a few  concepts  that  will  help  new  users  diagnose  their  own  problems  and 
utilize  "Help"  facililies  to  the  maximum  extent. 

Printed  user  manuals  exist  and  are  tyoically  provided  to  students  for  reference 
purposes  and  fur  study  after  they  have  gotten  fa.miliar  with  the  operation  of  the  TEN-C 
programs.  Since  few  new  users  (in  this  author’s  experience)  have  taken  the  tune  to 
study  tong  manuals  before  beginning,  this  strategy  is  likely  to  lead  to  increased  overall 
use  of  the  user  manuals. 

t.  Stress  direct  experiem  ’ rather  than  rienrious  experience.  The  tutor  does  not 
show  the  student  how  to  use  the  system.  Rather,  he  or  she  answers  questions  and 
makes  suggestions  designed  to  get  the  student  to  learn  what  to  do  at  first  and  .ns 
difficulties  arise. 

■T  Employ  learning  to  criterion  for  mastery  of  important  concepts.  There  are 
three  stages  of  concept  attaininent  in  the  tutorial.  The  first  involves  basic  concepts 
such  as  "file,"  "mode,"  and  "hierarchy." 

The  second  stage  involves  understanding  what  basic  commands  are  available  in  each 
of  the  modes  and  what  each  command  does.  The  third  stage  integrates  the  first  two  in 
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actual  use  of  TE.N-C  to  perform  a carefully  specified  scenario  of  tasks.  There  is  a set 
of  review  questions  for  each  stays-.  If  the  student  has  trouble  with  any  question,  he  or 
she  is  encouraged  to  reread  the  handouts  or  consult  documentation  until  the  correct 
answer  is  found. 

This  interaction  between  tutor  and  student  may  be  crucial  to  the  success  or  failure 
of  the  tutorial.  It  seems  premature  to  attenipt  to  replace  it  with  a computer  pre  gram. 
Hopefully,  this  can  be  done  eventually,  h the  meantirne,  tape  recordings  of  tutorials 
are  being  kept  for  future  analysis  should  such  a CAI  effort  be  undertaken. 


c.  noil'  run  nnoRi/n.  is  rnKsiuvrni) 

The  next  section  of  this  paper  contains  a written  description  of  what  is  intended  as 
a half-day  tutorial  on  the  use  of  TcN-C.  The  live  tutorial  involves  a high  level  of 
interaction  between  the  instructor  and  the  student,  especially  in  the  use  of  review 
questions  to  test  for  concept  and  skill  attainment.  Soine  of  this  tutorial  flavor  is  bound 
to  be  lost  in  this  written  presentation,  due  to  the  linear  sequencing  of  text  and  the  lack 
of  a tutor  (the  instructor)  to  correct  misconceptions  that  are  typically  revealed  duri  ig 
the  review  question  periods. 

We  considered  p'-eparing  this  tutorial  as  a "Prograrnmed  Text."  While  this  would 
work  well  in  print,  the  author  believes  that  it  would  be  a poor  means  of  teaching  the 
use  of  a complex  interactive  computer  system  to  highly-educated  decision-makers  and 
researchers.  We  decided  to  leave  the  human  instructor  in  the  loop.  This  paper  is  not 
oxponod  to  fully  substitute  for  a live  tutorial,  but  should  be  considered  as  a report 
describing  scch  a tutorial. 

The  tutorial  can  be  presented  in  a one-on-one  tutor-student  format  as  well  as  to 
SI,  all  groups.  The  review  questions  are  sornev/hat  less  effective  with  groups  since 
there  is  no  check  on  each  individual  student  for  each  question.  The  dialogue  between 
tutoi  and  student  is  valuable  in  either  format  and  greatiy  reduces  the  need  for  reading 
on  the  student  s part. 

The  only  reading  done  during  the  tutorial  is  of  the  handouts  which  are  presented 
one  at  a time.  These  are  all  reproduced  and  discussed  in  the  next  section  of  this  paper. 

The  instructor-tutor  follows  a specific  scenario  for  all  tutorials.  This  assures  that 
information  is  presented  in  a reasonable  order  for  incorporation  and  mastery  by  the 
student.  This  Instruction  Scenario  is  reproduced  below.  The  remainder  of  this  paper 
is  organized  by  the  steps  in  this  Instruction  Scenario.  Handouts  are  reproduced, 
verbatim,  on  separate  pages,  with  running  commentary  on  each  step  in  the  scenario. 


m 
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I nstrurliou  Srrunrio  For  Tlir  TE\-C  Tutorii  I 

1.  Instructor:  Check  to  see  that  the  terminal  is  working  properly  and  that  you  can 
access  the  net  to  the  ISI  computer.  Login.  Read  your  mail.  Logout. 

2.  Instructor:  Check  to  see  that  ail  necessary  learning  and  documentation  materials  are 
at  hand. 

3.  Instructor:  Begin  tutorial  with  orientation  to  the  learning  process.  Handou* 

"Orientation  Outline." 

4.  Instructor:  Hand  out  "Concepts  Used  in  this  Tuiorial". 

5.  Student;  Road  "Concepts  Used  in  this  Tutorial"  and  ask  questions  ot  instructor. 

6.  Instructor:  Check  comprehension  by  asking  student  the  review  questions  for 

"Concepts"  <cf  Review  Questions  - in  next  sectiOn>  Have  the  student  reread  the 
handout  until  answers  are  correct. 

7.  Instructor:  Hand  out  the  "Abbreviated  User  Manual". 

8.  Student;  Read  through  and  ask  questions  about  commands. 

9.  Instructor:  Check  comprehension  of  commands  by  asking  students  the  review 

questions.  <cf  Review  Questions> 

10.  Take  a break  prior  to  use  of  the  TEIM-C  System. 

11.  Student:  Review  "Abbreviated  User  Manual". 

12.  Instructor;  Hand  out  "Sample  Task  Description"  to  the  student. 

13.  Student;  Read  through  the  "Sample  Task  Description."  Login  to  the  system. 

14.  Student;  Go  through  the  exercise  with  the  instructor  present.  Ask  questions  as 
necessary.  Learn  by  trial  and  error  as  much  as  possible. 

15.  Instructor:  Hand  out  "Protocol  of  Successful  Task  Completion"  and  review  with 

student. 

16.  Take  a second  break. 

17.  Instructor:  Check  comprehension  by  asking  review  questions.  <cf  Review 
Questions> 


18.  Instructor:  Hand  out  the  "Tutorial  Evaluation  Questionnaire". 
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19.  Student:  Complete  que&tionn;tii  e evaluating  the  tutorial. 

20.  Instructor:  Hand  out  the  documentation  notebook  and  the  certificate  of  course 
completion. 

21.  Instructor;  Encourage  the  student  to  arrange  to  LINK  to  an  experier'cecl  TEN-C  user 
the  first  feA'  sessions  to  insure  availability  of  online  assistance. 


diK&MaiiMiai 
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D.  TUrOHini.  'INDCOMMEM^mV 

This  section  of  the  paper  presents  a running  commentary  on  the  tutorial.  This 
commentary  is  organized  by  the  steps  in  the  htstrnrtion  Srrmrin,  which  was  presented 
and  discussed  in  the  previous  section. 

1.  To  avoid  emtarrassment  and  waste  of  student  time,  the  instructor  always  checks 
the  availability  of  the  computer  system  immediately  preceding  the  tutorial.  This  is  a 
good  time  to  check  for  new  messages  relevant  to  TEN-C  use  or  training.  I'his  is 
done  withe*  the  student  pre,  ent  to  avoid  setting  up  a mystery-mastery  tone  for 
the  tutorial.  The  instructor  logs  out  of  the  system  since  it  will  not  be  used  in  the 
first  part  of  the  tutorial.  If  a tape  recorder  is  to  be  used,  it  is  checked  at  this  time, 
fhe  instructor  also  checks  to  see  that  he  or  c e has  the  !m:, union  Sernario  and 
the  Rrviow  (Jyn.^rion.s. 

2.  Handout  materials  are  arrangea  in  order  of  presentation.  These  include: 

1)  Orientation  Outline 

2)  Concepts  Used  in  this  Tutorial  & Review  Questions 

3)  Aobreviated  User  Manual  Review  Questions 

4)  Sample  Task  Description  Review  Questions 

5)  Protocol  of  Successful  Task  Completion 

6)  Tutorial  Evaluation  Questionnaire 

7)  Documentation  Notebook,  including 
XEO  Manual 

MSG  Manual 

ZCONFER  Com  nand  Summary 
TENEX-Notes  on  use 
Login  Scenario  appropriate  to 
local  situation 

8)  Certification  of  course  completion 

3.  The  01  lentatioi'i  begins  with  a very  brief  verbal  introduction,  such  as  the  following: 

"This  tutorial  is  designed  to  fnriliinir  Irnrnina  rather  than  to  tcarh.  As  a 
beginning  user,  you  are  encouraged  first  to  master  a few  basic  concepts,  which  are 
essential  to  understanding  how  the  programs  are  documented  and  operated;  Ihen  to 
experience  TZN-C  directly.  Learning  will  thus  be  through  trial  and  error  rather 
than  through  memorization  of  conkhook  procedures.  As  your  instructor-tutor,  I c;:ll 
not  "show"  you  how  to  use  the  TEN-C  System.  Rather,  I will  stand  by  to  answer 
questions  as  the  new  concepts  are  applied  and  problems  arise.  This  approach  is 
consistent  with  everyday  use  of  online  interactive  systems.  It  is  nearly  impossible 
to  plan  for  all  contingencies  in  the  documentation  and  training  for  a coinplex  system. 

"The  goals  ot  the  tutorial  are  for  you  to  develop  self-confidence  ar.d 
self-sufficiency  to  deal  with  the  problems  that  will  inevitably  arise  and  for  you  to 
progress  from  a simplistic  view  of  how  TKN-C  works  to  a creative  view  of  what  you 
can  do  with  it." 
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The  instructor  then  lianrJs  Out  the  Orirnuitinn  Oinlinr  (shovyn  below)  and  reads 
tlirough  it  with  the  student  to  make  sure  the  process  is  understooci  nnd  agreeable 
to  the  student. 

4.  The  instructor  hands  out  the  Conro/its  I si'll  In  I'ltis  Tiitori'il  (shown  below)  and 
reads  through  h.c  handout  with  ttie  student. 

5.  The  student  reads  the  Cow'i'jiis  handout.  Coinrueiits  and  questions  are  encouraged 
by  the  instructor.  I’he^e  ser'e  to  establish  links  between  the  student’s  prior 
knowledge  and  expectations  .and  the  new  informahon  being  presenled.  A tape 
recorder  is  used,  whenever  possible,  to  record  Ihis  part  of  the  tutorial  for  later 
analysis  of  questions  and  answers. 

6.  The  instructor  asks  the  Keiicw  Qui'stions  (see  beio.v)  which  pertain  to  ConrriJts. 
The  student  is  encouraged  to  looo  up  correct  answers  in  the  handouts  for  any 
missed  questions.  Misunde'-standings  get  cla.ifu'd  and  resolved  at  this  time. 
Students  also  typically  ask  many  questions  about  these  and  other  related  concrp's 
at  this  point  in  the  tutorial.  The  tutor  answers  questions  as  long  as  they  do  not  g ?t 
loo  far  off  the  path 

7.  As  soon  as  the  student  can  answer  the  AVricu:  (Jnrsiions  for  Couri'i)ts,  the 
instructor  hands  Out  the  /Vtbn'iinfi'd  l.'srr  Maiwnl.  (see  below.)  This  manual 
contains  one  or  two  pages  per  comriiand  mocie;  suminanzing  the  conventions  and 
basic  commands  for  each  mode  on  one  page  and  tlie  submode  options  on  a second 
page  when  necessary.  This  manual  can  be  inaiked  up  b/  the  student  as  questions 
arise  and  get  answered.  It  then  becomes  a personalized  !nt’'0ducti0n.  Reference 
can  be  made  to  the  one  or  two  pages  for  whicnever  mode  is  in.  current  use  by 
placing  the  manual  next  to  the  front  of  the  terminal. 

8.  T;ie  student  reads  througli  the  /Uihrorinii'd  I sor  MaiwnI  and  asks  for  clarification 
of  terms  that  are  not  immediately  obvious.  This  is,  perhaps,  the  most  impoi  tant  and 
yet  highly  variable  step  in  Ine  tutorial.  Students  are  not  gr  en  full  doc unientation 
on  the  various  programs  at  this  time.  They  are  reading  a highly  abridged 
description  of  the  several  con'mand  languages.  Tins  reduces  the  qu<.ntity  of 
information  to  be  read  (passive  learning)  and  increases  the  .aniount  of  information 
for  which  the  student  must  ask  the  instructor  (active  learning.)  This  step  is 
particularly  difficult  for  a person  who  is  trying  to  learn  to  use  TEN-C  by  reading 
this  report,  rather  than  Ijy  taking  tli.°  tutorial  with  an  experienced  instruciOr. 

9.  The  instructor,  at  the  r'^k  of  losing  the  student’s  faith  and  coopcjration,  goes 
through  the  Hrvirw  Qurstioits  for  tho  Lsrr  Mrtnitnl  (see  below.)  By  this  time 
students  are  typically  tired,  if  not  confused  as  well. 

10.  A much  needed  rest  break  is  taken  at  this  point  in  the  tutorial. 

11.  Following  the  break,  the  student  briefly  reviews  the  user  manual  and  asks  an/  new 
questions.  The  instructor  will  complete  the  Rniow  (Juosiions  for  ihr  Usrr  Mmtnnl 
if  these  were  not  completed  before  the  break. 
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12.  The  instructor  hands  out  ttic  Snmiilt>  Tank  hrxrnjiiinii  (see  below)  and  reads 
through  it  quickly  with  the  student. 

13.  The  student  briefly  reads  thiough  the  Stin/ilr  Task  and  then  goes  through  the  login 
procedure  with  the  "advice"  of  the  Instructor.  The  student  typically  takes 
"recipe-type"  notes  at  this  point.  It  seems  important  to  note  h.ow  to  turn  on  and 
adjust  the  terminal,  how  to  dial  up  and  connect  to  the  computer  or  TIP  port,  how  to 
get  connected  to  the  appropriate  computer  at  ISI,  and  how  to  login.  Since  this 
information  varies  from  location  to  location,  it  is  not  part  of  the  formal  handout  to 
new  users.  Personalizing  this  procedure  into  their  own  handwriting  seems  to  be 
important  to  most  students. 

1*5.  The  student  next  gO“s  through  the  Task,  often  asking  advice  of  the 

instructor.  Students  are  generally  willing  to  think  out  loud  and  don't  mind  their 
decision-processes  being  tape  recorded.  This  is  often  the  most  important 

opportunity  for  the  student  to  acquire  insight  into  the  interrelationships  among  the 
TEN-C  programs.  Students  may  realize  that  there  are  several  ways  to  perform 
some  of  the  tasks.  The  tasks  are  designed  to  encourage  use  of  every  mminand  in 
the  Ahltrrriaii'fi  Usrr  \lauiinl  at  least  once.  The  instructor  may,  occasionally,  need 
to  suggest  the  appropriate  command  for  a task,  if  the  student  runs  into  trouble. 

The  main  objective  of  this  step  is  for  the  student  to  gam  self-confidence  in  use  of 
the  p.ograms. 

15.  After  the  student  has  completed  the  task,  the  instructor  hands  out  and  reviews  a 
Protocol  of  Successful  Task  Coinpiciion  At  this  point,  the  instructor  can  discuss 
strategic  issues;  such  as  which  program  is  best  used  for  particular  types  of  tasks, 
under  particular  situations.  (For  example,  XED  or  MSG  may  be  a faster  and  more 
reliable  way  of  sending  important  or  long  messages  than  is  ZCONFER,  unless  of 
course  the  recipient(s)  are  currently  participating  in  ZCONFER.) 

16.  A second  rest  b'eak  is  taken  at  this  point. 

17.  The  instructor  next  asks  the  Hriicw  (fursllons  Tor  Saini)tc  Tasks.  This  provides 
One  last  opportunity  within  the  tutorial  for  the  student  to  integrate  what  has  been 
Icrirned  and  discover  remaining  ambiguities  and  rsisconc eptions. 

18.  The  instructor  hands  out  the  Tutorial  T.valuniiou  (Jiicsiioiwairr.  This  provides  the 
student  an  iiTirnediate  opportunity  to  make  complaints  and  suggestions  for  tlie 
improvemant  of  the  tutorial.  This  questionnaire  also  records  background 
information  about  the  student  which  may  later  be  useful  in  interpretation  of  the 
evaluation  or  in  description  of  Hie  user  population  for  a project’s  use  of  the  TEN-C 
System. 

19.  The  student  may  want  to  repeat,  m writing,  criticisms  and  suggestions  made  during 
the  tutorial.  Upon  completion  of  the  evaluation  questionnaire,  the  tutorial  is 
finished. 
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20.  Finjily,  ti'e  ‘Student  is  ^wen  d notebook',  coiitainmo  doi: uinentHtion  for  the  ZCO'IFFR, 
MSG  and  'ED  programs.  The  earlier  handouts  are  perforated  and  fit  into  the 
notebook  as\  well  Since  the  reference  manuals  for  all  of  thesr^  progranis  are 
maintained  up.-to-date  online,  they  are  not  mciuded  m this  report.  Ttiey  are, 
however,  given  do  graduates  of  tne  tutorial,  since  graduates  'a/iII  miov;  to  keep  up 
with  the  online  ncvhces  of  changes  m 'he  progr.ims, 

21.  The  instructor  typic  ally  ari  anger,  for  students  to  ha /e  some  form  of  expert 
assistance  available  dC-.-mg  ti  e nexi  few  sessions  m whiich  TEM-C  progi  ams  are 
used.  Inevitably,  there  II  be  problems  and  questions  that  did  not  cornrj  up  m the 
training. 


The  remainder  of  th'S  section  of  'lie  cjocurnent  contains  copies  of  tlie  liancioiits  given 
to  students  during  the  tutorial. 


ORIENTATION  OUTLINE 


1.  This  is  a complex  learning  task,  but  easily  managed  in  this  half  day  tutorial. 

2.  I,  (your  instructor)  am  available  only  once  for  a shcrt  t'Tie. 

3.  My  goal  is  for  you  (student/user)  to  quicKly  become  confident  and  self-sufficient  as  a 
learner  of  these  new  computer  facilities,  TEN-C. 

4.  The  form  of  learning  will  be  "conceptual  and  experiential,"  so  that  you  will  be  able  to 
learn  on  your  own,  <js  much  as  possible  without  any  help. 

5.  This  tutorial  includes  live  instruction,  an  "Abbreviated  User  Manual"  of  basic  program 
commands  ^nd  conventions,  online  documentation,  and  hard  copy  documentation. 

6.  If  this  approach  to  instruction  works  well,  we  rriay  write  a CAI  lesson  to  play  the  part  of 
the  instructor  a-'d  to  facilitate  interactio.n  with  the  online  documentation. 

7.  Your  comments  on  this  instruction  are  important  to  us  and  questionnaires  are  provided 
for  you  to  record  them  at  the  end  of  this  session.  -Ve  would  be  grateful  if  you 
would  use  a tape  recorder  throughout  the  tutorial  to  record  answers  for  the  review 
questions,  suggestions  for  improving  the  tutorial,  and  questions  you  have. 

8.  You  may  ask  any  questions  as  we  go  along  and  you  may  want  to  note  any  problems  you 
have  with  the  documentation. 

9.  Any  questions  so  far? 

10.  The  remainder  of  this  session  will  pri,jeed  as  follows: 

a)  You  will  read  an  introduction  to  "Concepts  Used  In  This  Tutorial." 

b)  I will  ask  you  some  questions  to  be  sure  you  fully  understand  these  basic 
concepts  before  you  go  on. 

c)  You  will  read  through  the  "Abb'"eviated  User’s  Manual." 

d)  I will  ask  you  questions  again,  to  be  sure  that  you  understand  how  to  use  the 
commands. 

e)  These  question-answer  sessions  are  intended  to  get  you  to  USE  the  concepts 
and  commands  prior  to  sitting  down  at  the  terminal  so  that  we  can  discuss  them 
more  fully  than  the  user  manual  does. 

f)  You  will  then  log  in  at  the  terminal  and  go  through  some  Sample  Tasks,  with  me 
here  to  assist  you. 

g)  There  is  a final  set  of  review  questions,  pertaining  to  the  sample  tasks. 

h)  You  evaluate  this  training  on  a questionnaire. 

i)  You  receive  a certificate  of  completion  for  the  tutorial. 
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CONCEPTS  USED  IN  THIS  TUTOR  I /IL 


In  order  for  you  to  become  a proficient  and  confident  user  of  TEN-C,  you  will  need 
to  understand  a few  basic  concepts  which  are  used  throughout  the  remainder  of  this 
tutorial.  They  were  selected  as  the  minimum  essential  for  you  to  be  able  to  "learn" 
(eventually  by  yourseir)  how  to  use  the  TEN-C  System  on  the  computer  at  the 
USC/Information  Sciences  Institute,  It  is  important  that  you  understand  these  concepts 
before  beginning  to  use  TEN-C. 

TEN-C:  The  Electronic  Notebook-Conference  System  is  a collection  of  programs  on  the 

iS18  computer.  These  programs  are  referred  to  as 

• TENEX  (PDP-10  Executive)  Language, 

• XED  (Experimental  Editor)  with  which  you  can 
create  and  edit  files  of  text, 

• MSG  (Message  Handling  Program)  for  sending, 
receiving,  reading  and  storing  files  which 

are  in  a message  format, 

• ZCONFER  (Conferencing  Program)  which  is 

used  to  create  and  access  the  notebook-conference 
transcript. 


ARPANET:  a digital  communications  network  connecting  more  than  90  computers 

throughout  the  United  States,  Norway,  and  England  (see  Figure  2).  Network  lines  can 
transmit  information  at  a rate  of  50,000  bits  per  second,  permitting  real-time  access  to 
any  ARPA  Host  computer  from  any  point  on  the  NET.  The  ARPANET  is  accessed  either 
via  a TIP  (and  the  TIP  User  Language)  or  from  a computer  via  TELNET  (and  its  user 
language).  Figure  3 shows  a geographic  map  of  the  ARPANET. 

MODES:  are  programs.  This  term  is  used  to  distinguish  the  "environments"  or 

"contexts"  in  which  user  commands  are  interpreted.  Within  TEN-C,  each  mode  (program) 
has  its  own  "command  interpreter."  Some  modes  in  turn,  have  "submodes".  For  example, 
ZCONFER  IS  a mode  within  TEN-C  System  and  INPUT  is  a submode  within  ZCONFER. 
Tyoically  it  is  necessary  to  formally  "enter"  a mode;  for  example,  by  typing  ZCONFER. 
Only  commands  appropriate  to  the  current  mode,  whatever  it  is  at  any  given  time,  will 
be  recognized  and  executed.  There  is  typically  an  identifying  prompt  unique  to  each 
mode.  Figure  3 shows  the  relationships  between  modes,  each  of  which  accepts  a 
particular  set  of  commands.  The  "Abbreviated  User  Manual"  is  organized  according  to 
these  modes,  listing  the  commands  and  conventions  unique  to  each. 


Network,  geographic  map.  Apri 


22 


I 


HIERARCHIES:  tree-like,  branching  structures.  Command  modes  and  submodes  are 

arranged  in  a hierarchy  (see  Figure  3).  Within  ZCONFER,  the  conference  topics,  and 
activities  are  arranged  in  hierarchies.  CSenerally,  the  lines  of  a hierarchical  diagram 
indicate  "commands"  you  must  enter  to  get  from  one  point  to  another. 

COMMANDS:  are  recognized  by  each  program.  Only  the  most  important  ones  are 

presented  in  this  tutorial  in  the  "Abbreviated  User  Manual."  More  comprehensive  user 
manuals  are  provided  at  the  end  of  the  tu*orial.  In  any  mode  (with  the  exception  of 
INPUT  submodes),  typing  ? will  cause  a list  of  all  command  options  to  be  typed  at  the 
terminal.  Commands  can  only  be  typed  following  a prompt  from  the  current  mode  or 
submode. 

CONVENTIONS:  for  each  mode  are  listed  on  the  respective  pages  of  the  "Abbreviated 

User  Manual."  Almost  all  TENEX  conventions  work  in  the  XED,  ZCONFER,  and  MSG  modes. 
The  TENEX  conventions,  at  least,  should  be  "memorized"  prior  to  beginning  use  of 
TEN-C. 

COMMAND  RECOGNITION;  a convention  in  this  system  which  requires  you  to  type  only 
enough  information  (i.e.,  letters)  to  distinguish  a command  name  from  others  available  in 
the  r Trent  mode.  Typically  this  requires  only  one  or  two  letters.  In  MSG  and  XED,  the 
program  automatically  recognizes  a command  after  a single  letter  has  been  typed.  The 
other  modes  (TENEX  and  ZCONFER)  have  a manual  command  recognition  option.  You 
may  either  type  all  letters  in  the  command  or  you  may  type  at  least  the  minimum 
necessary  letters  followed  by  hitt  ng  the  [ESC]  key.  This  causes  the  program  to 
complete  typing  the  command  name  and  specify  any  "parameters"  necessary.  If  the 
program  responds  with  a BELL  or  BEEP  when  you  hit  [ESC],  that  means  more 
information  is  necessary  to  distinguish  the  command.  The  [ESC]  key  m.ay  also  be  used 
for  FILE-NAME  recognition.  .Vote:  Some  ierminals  have  an  [ATTN]  key  which 
corresponds  to  the  [ESC]  key  in  this  documentation.  Keys  on  the  terminal  are  indicated 
in  the  documentation  by  the  [square  brackets]. 

COMMAND  COMPLETION:  is  sometimes  requested  by  the  program.  To  indicate  to  the 

computer  that  you  have  specified  a parameter  value  or  have  fully  specified  a command 
and  that  it  is  ready  to  be  executed,  you  have  to  hit  the  [CR]  key.  Sometimes  the 
program  will  explicitly  request  you  to  "CONFIRM"  the  command  as  specified.  Use  the 
[CR]  Key.  i\otc:  Some  terminals  have  a carriage  return  [CR]  key  labeled  as  [RETURN]. 

PARAMETERS:  are  variables  within  a command  specification.  Some  commands  have 

parameters  which  are  optional;  some  must  be  specified.  Typing  a ’ will  typically  p-et 
you  a list  of  parameters  inside  a command  specification.  Parameters  are  indicated  in 
the  documentation  by  the  words  in  <ANGLE>  brackets.  Generally  you  have  to  type 
what  is  in  capital  letters  and  substitute  a value  for  the  parameters  indicated  by 
brackets.  Do  not  type  the  brackets  theii  °lves. 


Figure  3.  TEN-C  command  mode'.  tAodis  have  commands  aiid  prompts  and 

are  represented  by  boxes;  input  subnodes  are  represented  by  balloons. 
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For  example,  <Put  <MESSAGE-SEQUENCE>[CR]  into  file:  <FILE-NAME>  [CR] 
Might  look  like  Put  (entries)  1-9,  13  [CR]  into  file:  LPT:  [CR] 


Note  that  only  the  characters  P 1-9,  13  [CR]  LPT:  [CR]  would  actually  be  typed.  The 
system  tilled  in  the  rest  of  the  characters  (ones  in  lower  case).  This  is  an  MSG 
command  which  would  put  the  specified  messages  out  onto  the  main  line  printer.  Note 
that  command  completion  [CR]  is  nece;  sary  to  indicate  the  end  of  each  parameter 
specification.  MSG  has  "automatic  command  recognition"  (see  above.) 

DOCUMENTATION  CONVENTIONS:  as  follows  ,.''6  used  throughout  this  tutorial,  in  the 
Abbreviated  User  Manual,  and  in  the  online  help  ncilities. 

CAPITAL  LETTERS  * what  you  must  type  in  issuing  a command 

lower  case  letters  = what  the  program  will  type  to  complete  the  command 
specification  or  to  prompt  you  for  more  information. 

[SQUARE  BRACKETS]  - a special  key  to  be  hit 

<ANGLE  BRACKETS>  * a parameter  for  which  you  must/may  specify  some 
value(s) 

(parentheses)  » nothing  special.  Part  of  the  way  the  system  prompts  for 
information. 

FILE  NAMES:  can  be  specified  by  typing  at  least  the  minimum  number  of  unique 
characters  followed  by  hitting  an  [ESC]  key.  For  example,  if  you  have  only  a 

MESSAGE.TXTil  file  in  your  directory,  then  typing  the  letter  "m"  and  hitting  the  [ESC] 
key  will  specify  it.  The  computer  always  types  out  the  full  name  for  yrur  confirmation, 
[CR].  So. lie  special  filenames  are: 

message.txt  - never  edit  this,  it  is  read  automatically  by  MSG. 

Ipt:  - send  to  the  lineprinter  at  ISI,  rather  than  to  a file. 

tty:  - send  to  this  terminal,  rather  than  to  a file 

In  response  to  a prompt  for  a file,  you  can  specify  a new  file.  The  program  will  inform 
you  whether  any  file  name  is  new  or  old  and  request  confirmation.  Hit  [CR]  key  to 
confirm.  Hit  [DEL]  or  [RUBOUT]  to  abort  the  specification.  The  structure  of  a filename 
is  "FILENAME.FILETYPEjVERSION  NUMBER".  For  example,  you  rtiijht  name  a file 
"junk.text;!".  Any  short  string  of  characters  can  be  used  for  a filename  or  filetype. 
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REVIEW  QUESTIONS  FOR  CONCEPTS 


The  concepts  presented  above  are  essential  to  your  understanding  and  use  of 
TEN-C.  They  enable  you  to  learn  experientially  and  to  take  advantage  of  the  online 
documentation  and  user  manuals. 

Before  going  on  with  the  tutorial,  you  should  be  able  to  correctly  answer  the 
following  Review  Questions.  Refer  to  the  preceding  discussion  of  "Concepts,"  if 
necessary,  to  be  certain  that  you  have  "mastered"  these  concepts. 

1.  What  is  a mode? 

2.  How  do  you  know  what  mode  you  are  in? 

3.  When  can  you  use  the  TENEX  conventions? 

4.  What  is  command  completion?  How  is  it  done? 

5.  If  you  hit  [ESC]  after  typing  the  first  letter  of  a command  and  a bell  rings,  but  no 
prompt  appears,  what  does  this  mean? 

6.  How  do  you  get  help  when  the  above  happens? 

7.  How  do  you  get  a listing  of  parameter  options? 

8.  In  the  documentation,  what  do  square  and  angle  brackets  and  parentheses  indicate? 
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ABBREVIATED  USER  MANUAL 


The  Electronic  Notebook-Conference  (TEN-C)  System 

CONVENTIONS: 

Each  mode  (environment  for  entering  commands)  is  summarized  on  one  page. 

Commands  with  complex  options  or  subcommands  are  described  in  detail  on  an  adjacent 
page. 

Conventions  unique  to  each  mode  are  listed  before  the  commands  on  each  page. 

Not  all  commands  in  each  mode  are  listed  here;  only  the  most  important  ones. 

DOCUMENTATION  CONVENTIONS  (for  these  cards  and  for  online  explanations): 

[FUNCTION]  - square  brackets  refer  to  a function  key  on  the 
terminal. 

<PARAMETER>  - angle  brackets  mean  you  substitute  a value  for 
the  parameter. 

UPPER  CASE  - refers  to  what  you  must  type  for  the  program  to 
recognize  the  command 

lower  case  - refers  to  what  the  system  will  type 

[TC]  - is  read  as  "control  C."  To  enter  [TC]  hold  the  CNTL 
key  down  and  type  the  [C]  i^ey.  The  T re'ers  to  [CNTL]. 

NOTE:  A tew  terminals  have  a key  with  [T]  on  it.  Do  NOT  confuse 

this  with  the  [CNTL]  key. 

MODES:  (and  corresponding  prompt) 


ZCONFER 
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TENEX  Evecutive  System  (for  PDP-iO  Computer)  MODE 
@ prompt  by  system 

CONVENTIONS:  (these  hold  also  for  XED,  ZCONFER  and  MSG  modes.) 


[DEL]  or [RUBOUT] 

[TCI 

[TA] 

[TW] 

[ESC] 

[TR] 

[CR]  or  [RETURN] 


abort  command  (prior  to  executing  it  with 
[CR],  except  in  XED  mode;  negative  confirmation) 
abort  program;  return  to  J?  prompt  in  TENEX  mode 
character  delete  (also  [TH]  and  [BACKSPACE]) 
word  or  string  dek^te 

command  completion  character;  except  in  XED  mode, 
retype  line  being  input 
command  termination;  positive  confirmation 
list  of  local  options 


COM  y.  /iNDS:  (a  small  subset  of  all  TENEX  commands) 


DIRectory 

LOGIN  <NAME>  <PASSW0RD>  <ACCT> 

LOGOUT 

MSG 

TERminal  <TYPE> 

XED 

ZCONFER 


lists  files  in  your  directory 

leaves  TENEX,  reti.rn  to  TIP  mode 
invokes  message  r.  ode 
specifies  terminal  type  (?  for  options) 
invokes  text  editor  mode 
invokes  conference  mode 
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MSG  (Message  Processing  System)  MOC'E 
<-  prompt 


CONVENTIONS:  (two  submodes:  inputting  messages  (SNDMSG)  and  executing 

commands) 


Tvpe  only  the  fifit  letter  of  each  command.  Wait.  The  system  will  type  out  the  rest 
and  prompt  you  for  additional  information.  Hit  [CR]  only  ?t  the  end  of  the  command. 
? gets  help. 

<FILE-NAME>  - any  name.  LPT:  and  TTY:  used  as  file  names  send  output  to  the 
lineprinter  or  your  terminal,  respectively.  You  may  create  a filename  for  a new  file. 

<MSG-SEQUEI\ICE>  - any  integer  or  several  integers  separated  by  or,  < . 

These  numbers  are  used  to  refer  to  messages.  There  are  other  mnemonic  options, 
such  as  "A"  for  "all  messages." 

All  TENEX  conventions  hold,  m addition  to 

[TZ]  - indicates  end  of  message  input 

[TO]  - aborts  terminal  output  or  message  input,  returns  to  <- 

[CR]  - command  termination  character  and  positive  confirmation 

[TQ]  - deletes  current  line  of  message  text  input 

[TS]  - retypes  entire  message  entered  so  far 

[DEL]  - aborts  SNDMSGj  return  to  <-  in  MSG  mode  (also  [RUBOUT]) 

COM  M /INDS:  (a  small  subset  of  all  MSG  commands) 


E exit  and  update  old  file 
H headers  All 

P put  <MSG-SEQUENCE>  into  file: 
<FILE  NAME> 

Q quit 

T type  <MSG-SEQUENCE> 

V verbose 
X xed 


list  headers  of  all  messages 

put  a copy  of  messages  there 
don’t  update  msg  file 
type  on  terminal 
give  verbose  prompts 
go  into  XED  mode 
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XEO  (Text  Editor)  MODE 
: prompt 

CONVENTIONS:  (three  submodes:  inputting  text,  executing  commands,  and  changing  a 
line) 

Type  only  the  first  letter  of  the  command  you  wish  to  execute.  XED  will  complete  the 
word  and  wait  for  parameters  or  execute  the  command  if  there  are  no  parameters. 

XED  maintains  a "pointer"  to  a "current  line."  All  commands  operate  on  that  line  and 
below  in  the  text  file.  Typing  a number  BEFORE  a command  name  moves  the  pointer  to 
that  line  before  executing  the  command.  Numbers  FOLLOWING  a command  specify  the 
number  of  lines  to  be  affected  by  the  command,  e.g.,  "9k5"  will  kill  lines  9 THROUGH 
13. 

Command  recognition  is  automatic  in  XED.  The  editor  acts  on  the  first  character  of  a 
command  and  waits  for  parameters,  subcommands,  or  [CR]  confirmations,  if  any  are 
required. 

XED  will  maintain  for  each  user  a "profile"  of  terminal  characteristics  and  conventions 
preferred  by  the  user.  Type  a double  quote  (")  as  an  XED  command  to  initiate  the 
question-answer  sequence  which  creates  this  MODEFILE.  All  other  TENEX  conventions 
hold,  in  addition, 

[DEL]  - character  delete 
[tX]  - deletes  current  line  being  input 
[TQ]  - aborts  a partially  specified  command 
[TO]  - aborts  an  executing  command 
[TZ]  - terminates  text  input  mode;  return  to  : prompt 
in  XED  command  mode 

COMMANDS: 

? command  menu 
A append  new  input 
C change  line  (see  SUBCOMMANDS*) 

E exit  and  save  file;  <FILE-NAME> 

F find  string  o'  text  <STRING> 

7.  send  text  file  as  message 

[+]<NUM>  forward  NUM  lines 
[T]  print  previous  line 
[LF]  print  next  line 


♦SUBCOMMANDS  for  the  CHANGE  submode  are  listed  on  the  next  page. 


H<letter>  explains  command  of  "letter" 
K<NUM>  kill  one  or  more  lines 
0 quit  XEDi  return  to  previous  mode 
R read  in  file:  <FILE-NAME> 

T<NUM>  type  one  or  more  lines 
V view  i6  lines  from  current 
<FILE-NAME> 

[-]<NUM>  backward  NUM  lines 
[/]  print  current  line 
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SUPPLEMENT  TO  XED  - CARD  2 


C CHANGE  command  is  used  to  alter  the  current  line  of  text.  Typing  "C”  puts  you  in 
a submode  where  the  following  subcommands  are  used  to  1)  copy  characters  from  the 
old  line  into  the  new  line  ([SPACE], E,S)  2)  delete  characters  from  the  old  line  (D,K,R) 
and  3)  add  characters  to  the  new  line  from  the  keyboard  (1,R).  All  <NUM>  parameters 
default  to  1,  if  not  specified.  <CHAR>s  default  to  [SPACE]. 


SUBCOMMANDS: 


<NUM>[SPACE] 

B 

<NUM>D 

E 

I 

<NUM>>(<CHAR> 

P 

<NUM>R 

<NUM>S<CHAR> 

<NUM>V<CHAR> 

[CR]  or  [RETURN] 

[LF] 


prints  a list  of  subcommands 

spaces  N characters  forward,  copying  old 

to  new  as  is 

breaks  line  and  inserts  new  line 
deletes  N characters  forward  from  old  copy 
move  to  end  of  old  line  copying  old  to 
new  as  is. 

insert  following  text  until  [CR],[LF]  or  [TZ] 
delete  until  Nth  occurrence  of  CHAR 
print  remainder  of  old  line  and  new  version 
of  current  line. 

delete  ..ext  N characters  and  enter  INSERT 
mode  (above) 

copy  forward  until  Nth  occurrence  of  CHAR 
invert  case  of  all  alphabetics  up  to  Nth 
occurrence  of  CHAR 
copy  remainder  of  old  line  to  new 
update  current  line  to  new,  as  is 
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f 

f 

f 


ZCONFER  (conferencing-notebook)  MODE 
- prompt 


CONVENTIONS:  (three  submodes:  listening,  inputting  entries,  and  executing) 
All  TENEX  conventions  hold,  in  addition. 


[OR]  or  [ESC] 
[CR][CK] 

[CR] 

[0EL][0EL] 

[TO] 

[IS] 


completes  command  or  causes  system  to  prompt 
for  information 

indicates  that  entry  is  complete:  submits 
it  to  the  database 

(as  first  character  of  a line)  change  between  listen 

and  command  submodes 

entry  delete  in  input  mode;  skips  to 

next  entry  when  text  is  being  displayed 

cancels  typeout  for  entire  command 

retypes  entire  entry  up  to  that  point  in  input 


? lists  options  within  a command  as  well  as  overall  command  options. 


COMMANDS:  (a  subset  of  all  ZCONFER  commands) 

AGenda  lists  Topic  and  Activity  hierarchy 

CHange  (password)  <NEW  PASSW0RD> 

GO  (to  activity)<NUM>  move  among  activities 
Quit  graceful  exit  from  ZCONFER  to  TENEX 

REView  (eritries)<OPTION>  see  next  page  for  OPTIONS  list 
STatus  (of  participants)  tells  where  in  the  hierarchy 

participants  are  active 

submit  (file)<FILE-NAME>  gets  a file  from  your  directory, 

created  earlier  with  XED 
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SUPPLEMENT  TO  ZCONFER  - C/iRD  2 

Describe  <COM M/lND-N/iME>  - provides  online  documertation  of  these  plus  the 
following  additional  ZCONFER  commands:  Put,  SAve,  Next,  Activity,  COnferance,  Exec, 
REStart,  STatus.  "Describe  ALL"  prints  a description  of  ZCONFER  commands  on  your 
terminal. 

REView  (entries)  <OPTION(S)^  - retrieves  and  displays  the  discussion  entries  you 
specify. 

Put  (entries)  <OPTION(S)>  into  file:  <FILE-NAME>  - outputs  the  specified  entries 
into  a file  {which  you  can  then  edit  and  list,  for  example). 


OPTIONS:  The  following  OPTIONS  can  be  used,  alone  or  in  combinations,  with  either 

the  Put  or  the  REView  command: 

BY  <a  list  of  participant  names  (or  the  word  ALL)> 

IN  <a  list  of  entry  numbers  (or  the  word  ALL)> 

LAST  <NUM>  entries;  to  see  only  the  previous  entry,  simply  type 
LAST 

BEFORE,  ON  or  AFTER  <a  date  such  as  17-APR-73  or  5/17/73> 

BETWEEN  <a  date>  AND  <another  date> 

RE  <a  topic  word  in  quotation  m trks>;  e.g.,  RE  "energy" 

In  addition,  if  you  do  not  wish  to  see  the  heading  and  complete  text  of  the  entries  you 
have  specified,  you  may  use  any  of  the  following  restrictions: 

BY  FIRST  LINE 
BY  FIRST  <NUM>  LINES 
NO  HEADING 
NO  TEXT 


SUMMARY  OF  COMMANDS  IN  TEN-C  TUTORIAL 


TENEX:  (@  prompt) 

directory 

terminal 

login 

xed 

logout 

zconfer 

msg 

MSG:  (<-  prompt) 

exit 

type 

headers  all 

verbose 

put 

xed 

quit 

XED:  (:  prompt) 

append 

quit 

change* 

ead 

exit 

type 

find 

view 

help 

write 

kill 

7. 

♦CHANGE  SUBCOMMANDS:  [space],  end,  insert,  delete,  copy  old  to 
new,  [LF],  breaK  line,  search  forward,  print,  replace,  invert 


ZCON'^ER:  (-  prompt) 
agenda 
change 
go 
quit 


review** 

status 

submit 


**REVIEW/PUT  OPTIONS:  by,  in,  last,  before,  re,  no  text 
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REVIFAf  QUESTIONS  FOR  ABIIREVI/ITED  USER  MANUAL 


You  are  probably  now  suffering  from  an  information  overload.  Don’t  worry!  You 
can  refer  back  to  th<;  pages  of  the  Abbreviated  User  Manual  to  answer  any  of  these 
review  Questions. 

It  is  important  for  you  to  review  at  least  the  following  questions  before  going  on  to 
use  TEN-C.  As  you  go  through  these  review  questions  feel  free  to  ask  questions  of 
your  instructor. 

1.  What  are  the  four  basic  modes? 

2.  What  is  the  prompt  from  the  system  for  each  mode? 

3.  Go  through  each  command  and  guess  what  it  does.  <lnstructor  confirms  or  corrects 
each  guess> 

4.  What  are  the  eigh‘  TENEX  conventions?  <List  these  from  memory>  <HINT:  abort 
command,  abort  program,  delete  character,  delete  word,  command  completion,  retype 
line  input,  command  termination,  list  options> 

5.  How  can  you  go  directly  from  each  of  these  modes  to  the  other:  TENEX,  XED, 

ZCONFER,  MSG. 

6.  Are  there  any  TENEX  conventions  which  are  not  valid  in  all  other  modes? 

7.  From  what  modes  (or  submode)  can  you  send  a message  to  another  user? 

8.  A much-needed  rest  break  is  taken  at  this  point  in  the  tutorial. 

9.  Following  the  break,  the  stude  it  briefly  reviews  the  user  manual  and  asks  any  new 
questions. 
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SAMPLE  TASKS  TO  ACQUAINT  YOU  WITH  USE  OF  TEN-C 


The  following  sequence  of  tasks  will  lead  you  through  use  of  the  four  basic  modes 
of  TEN-C. 

This  is  the  most  critical  step  in  the  tutorial;  where  you  first  apply  the  concepts, 
conventions,  and  commands  learned  up  to  this  point.  This  experimental  step  is  designed 
to  let  you  make  some  mistakes  at  first  and  go  on  to  develop  a sense  of  confidence  in 
your  ability  to  learn  to  use  the  TEN-C  System. 


1.  Obtain  assistance,  if  necessary,  in  order  to  login  to  the  ISI-KI-TENEX  computer,  using 
your  own  account  or  the  special  account  assigned  to  you. 

2.  Specify  your  terminal  type  to  the  system. 

3.  Check  your  mail  to  see  if  you  have  messages. 

4.  If  you  are  using  a special  guest  account  for  TEN-C,  locate  and  typeout  the  message 
or  messages  about  "first-time  users."  Otherwise,  type  out  any  message  in  your 
message  file. 

b.  Put  the  oldest  of  the  above  messages  into  a file  calleC  <YOUP-LAST-NAME.TEXT>. 

6.  Go  directly  from  MSG  into  the  text  editor. 

7.  Get  into  text  input  mode  in  XEO.  Type  in  a message  to  one  of  le  people 
mentioned  in  the  message  you  read  earlie”,  identifying  yourself,  announcing  your 
presence  in  the  TEN-C  System. 

8.  Send  copies  of  the  message  to  yourself  (the  account  name  you  are  using)  and  to 
others  mentioned  in  the  message.  Do  this  while  in  XED. 

9.  Return  to  MSG,  by  typing  quit  to  XED. 

10.  Type  the  new  message  while  in  MSG  mode. 

11.  Use  the  XEO  editor  again.  Read  in  the  file  you  put  out  from  MSG  called 
<YOUR-LAST-NAME.text>.  If  there  is  none,  create  a file  with  10  lines  of  text. 

12.  View  the  entire  file. 


13.  Type  lines  3 and  4. 
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14.  Put  your  name  at  the  bottom  of  the  file. 

15.  View  the  entire  file  again  to  check  your  editing. 

16.  If  you  made  an  error  in  placing  the  new  line,  then  use  the  K command  to  kill  it. 
Remember  to  specify  the  line  number  before  the  lettc"  K.  Now  specify  the  line 
number  for  the  end  of  the  file  and  add  the  date  after  your  name  (on  the  same  line). 

17.  From  XEO,  invoke  SNDMSG  and  send  the  message  (i.e.,  the  current  file)  to  yourself. 
Stay  in  XED. 

18.  Save  the  file  with  the  W command.  To  specify  <FILENAME>  I.'  the  [ESC]  key.  This 
defaults  to  a new  version  number  of  the  same  name.  If  you  c..  ated  a new  file,  then 
give  it  a name  here. 

19.  Find  out  what  commands  are  available  on  XED. 

20.  Find  out  how  to  use  SNDMSG  (7)  from  XED,  using  the  H command. 

21.  Leave  the  editor,  gracefully. 

22.  Begin  using  ZCONFER. 

23.  Read  all  entries  in  Activity  1.1  of  the  conference  which  most  appeals  to  you. 

24.  Make  an  entry  in  this  activity. 

25.  Review  the  3 newest  entries  in  Activity  1.1. 

26.  Go  to  another  activity.  Review  all  entries  there,  aborting  any  that  seem  too 
verbose. 

27.  Put  the  message  you  created  and  saved  as  a file  (in  step  18)  into  the  conference  as 
a new  entry  in  Activity  1.1. 

28.  Check  the  conference  agenda  and  the  status  of  other  participants.  Leave  the 
conference,  gracefully. 

29.  Print  out  a list  of  files  in  your  account  directory. 

30.  Edit  the  file  with  your  message  in  li  tc  state  that  you  have  now  completed  the 
introductory  training  for  TENEX,  XED,  MSG  and  ZCONFER.  Add  comments  regarding 
any  serious  problems  you  encountered. 

3‘.  From  within  the  editor,  send  this  file  to  the  same  people  as  before. 

32.  Leave  the  editor. 

33.  Log  out  of  TENEX  (and  close  the  TIP  connection  if  you  used  the  TIP). 
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REVIElf  QUESTIONS  FOR  S/IMPLE  TASKS 

1.  In  what  mode  do  you  enter  the  system? 

2.  What  mode  do  you  enter  next? 

3.  What  are  your  options  after  logging  into  TENEX  at  ISI? 

4.  What  similarities  across  ZCONFER,  XED,  WSG  modes 
did  you  notice? 

5.  What  differences  among  modes  did  you  notice? 

6.  How  do  you  get  online  help  in  each  mode? 

7.  What  is  an  entry?  a message?  a file? 

8.  What  are  topics  and  activities  in  ZCONFER? 

9.  How  do  you  move  among  topics  and  activities? 

10.  What  advantages  are  there  in  using  all  three  of  the  programs  XED,  MSG  and 
ZCONFFR  together? 

11.  What  commands  do  you  wish  you  could  have  that  were  not  in  the  "Abbreviated  User 
Manual"?  How  do  you  find  out  if  they  already  do  exist? 
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TUTORI/IL  EV/IUJ/ITION  QUESTIONNAIRE 


1.  Name: 

2.  Office: 

3.  Phone: 

4.  Terminal  location: 

5.  Phone  near  term'  al: 

6.  Names  of  other  local  users  on  ARPANET: 

7.  Date  of  training: 

8.  Trainer: 

9.  What  previous  experience  have  you  had  with: 

a.  The  ARPANET 

b.  online  conferencing 
text  editors 

d.  message  systems 

e.  I ENEX  systems 

f.  PLATO  system 

g.  TUTOR  author  language 

h.  other  online  systems 


MUMiiiilMMiiiiii 
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SCORE  ANSWERS  FOR  EACH  OF  THE  FOLLOWING  QLCSTIONS: 
5 “ extremely 
4 « very 
3 - average 
2 - not  very 
1 > not  all  all 
0 - don’t  know 

10.  How  difficult  overall  was  the  training  for  you? 

1 1.  How  tuccettfully  do  you  believe  you  learned  to  use  each 

of  the  following: 

A.  TENEX  commands 

B.  ZCONFER 

C.  XEH 

D.  MSG 

E.  TEN-C  as  a whole 

12.  How  effective  were  each  of  the  following  for  you: 

A.  Hc.'idOL't  on  Concepts 

B.  Abbreviated  Ujors  Guide 

C.  Review  Questions 

D.  Sample  "!  asks 

E.  Trainer' 

F.  Online  Help 

G.  Training  Approach  in  General 
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13.  Please  state  any  suggestions  you  have  for  improving  the  training  process: 


14.  What  are  your  initial  reactions  to  these  new  programs? 


15.  How  much  to  you  expect  to  use  the  ARPANET  for  TEN-C  activity  in  the  next  year? 


16.  Hov/  many  hours/week  (minimum  ->  maximum)  might  you  spend  online  ‘n  T£i'!-C 
activity  in  the  next  few  months? 


17.  Do  you  expect  the  TEN-C  System  to  support  or  hinder  your  project?  Please  explain 
why: 


E.  li  II  EKE  no  » E r.O  I' KO  U II EHE? 


This  document  r'j-orls  progress  made  on  the  development  of  a tutorial  for 
introducing  users  to  : n 'Ef!  C Systern,  As  of  this  writing,  the  tutorial  .s  in  a rriore  or 
less  dormant  stage.  Ws  not  plan  to  apply  or  evaluate  it  in  any  projects  currently 
funded.  However,  we  ’ ave  thouglit  about  its  future  (ievelopinent.  In  closing,  we 
suggest  some  stepv  w-ifli  should  be  taken  pnor  to  or  as  a part  of  an,  future 
application  of  the  TEfJ-C  itonal. 

Eirst,  the  effectiveness  of  the  tutorial  should  be  clearly  established.  This  can  be 
done  in  comparison  w:tl'  othei  training  methods  or  with  respect  to  prespecified 
performance  constraints.  , Evaluation  criteria  miglit  include  cost  and  time  to  present  the 
tutorial,  error  rates  for  use  of  ihe  TEi'J-C  programs,  and  user  attituc.es,  A questionnaire 
was  included  m the  previous  section  of  this  report,  which  can  be  used  to  record  user 
characteristics  and  attitudes  toward  the  tutorial  and  the  TEN-C  S'  steni. 

Such  a forma'  evaluation  has  not  yet  been  uiidertaKc'n.  The  tutorial  has  evolved 
wi'li  successive  training  situations,  eacii  of  which  trained  only  one  or  two  students.  A 
larger  sample  of  students  must  be  trained  before  ciefinitive  evaluation  of  the  tutorial 
can  be  made. 

Modification  of  the  tutorial  may  be  necessary  to  acconrimodate  new  users  with 
special  backgrounds.  For  example,  son.eone  familiar  with  another  text  editor  on  the 
PDP-10  might  want  to  cont  nue  using  that  editor  in  place  of  XED.  Experienre  with  the 
I'nak  may  well  suggest  that  it  he  revised.  P?vision  of  the  progranis,  wtiich 
continually  goes  on  at  ISI,  may  •'equiie  updating  of  the  handouls. 

tn  any  case,  this  tutorial  represents  an  alternative  to  t!ie  typical  approaches  to 
training  new  users;  cookbook  descriptions  of  procedures,  reading  lengthy  user  inanuals, 
and  tworst  of  all)  the  "watch  me  and  reiviember"  ted'.mque.  It  greatly  reduces  the 
number  of  commands  to  be  learned  and  used  as  the  student  is  getting  used  to  the 
collection  of  program  command  languages.  It  introduces  some  of  the  underlying 
concepts  necessary  for  an  under  standing  of  TEN-C,  without  requiring  the  new  user  to 
become  a progi'ainrner.  Finally,  this  tutorial  presents  an  integrated  orientation  to  a set 
of  sopiiisticateo  programs  for  electronic  notebook  and  conferencing  activity. 
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/)PPKSl)l\  I : ZCONP Pli  Commnnd  l)o.%rrii>iions 


The  following  is  a slightly  extended  version  of  the  online  documentation  for  the 
ZCONFER  program.  First  a list  of  commands  is  presented.  Then  a brief  description  of 
each  command  is  given. 


COMMANDS:  (do  not  type  tlie  words  in  p:  entheses.) 

Activity  (information) 

AGenda  (information) 

CHange  (password)  <NEW  PASSW0RD> 
conference  (information) 

Describe  <SUBCOMMAND> 

Exec 

Go  (iu  activity)  <NUMBER> 

Join  (conference)  <NUMBER> 

Next  (activity) 

Put  (entries)  <0PTI0N> 

Quit 

REStart 

REView  (entries)  <0PTI0N> 

SAve  (transcript  for  activities)  <NUMBER> 

STatus  (of  participants) 
submit  (file)  <FILENAME> 


DESCRIPTIONS  OF  THE  COMMANDS: 


ACTIVITY  --  prints  out  the  name  and  any  background  information  for  the  current 
activity. 

AGENDA  --  prints  out  the  "topic  structure"  for  the  conference. 

CHANGE  --  permits  you  to  change  your  password  to  the  word  specified.  For 
example,  type  "change  1776" 

CONFERENCE  --  prints  out  the  title  a.id  any  background  information  for  the 
cor’ference. 
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DESCRIBF.  --  explain*;  the  u;.e  of  other  coniinands.  For  example,  “describe  save” 
explains  the  SAVE  command,  "describe  all"  will  print  out  a description  of  all 
action  comimands 

EXEC  --  starts  a lower  "fork"  with  the  TENEX  executive  This  allows  you  to  run 
anotlier  program,  such  as  the  XED  text  editor.  To  return  to  the  conference 
from  TENEX  (iD  Prompt),  you  type  "quit"  as  a TENEX  cominand.  You  will  be  in 
command  mode  in  the  conference  again. 

GO  — inOves  you  to  another  activity  witicin  the  conference. 

JOIN  --  puts  you  into  the  conference  you  specify.  If  you  want  a list  of  conferences 
open  to  you,  type  "jom  ’". 

NEXT  --  moves  you  to  the  next  activity  on  the  agenda,  if  there  is  one. 

PUT  --  puts  the  entries  you  specify  from  the  present  activity  into  the  file  you 
specify.  This  rnay  be  an  already  existing  file  or  a new  file.  To  send  this  listing 
to  a lineprinter,  specify  the  file  as  'lpt:“.  (Don't  omit  the  colon.) 

To  specify  entries  you  may  use  any  of  the  following,  alone  or  m cornhinations 
(with  either  the  Put  or  the  REView  command): 

BY  <a  list  of  participant  names  (or  the  word  ALL)> 

IN  <a  list  of  entry  numbers  (or  the  word  ALL)> 

LAST  <N!JM>  entries;  to  see  only  the  pre..Ous  entry,  simply  type  LAST 
BEFORE,  ON  or  AFTER  <a  date  such  as  17-APR-73  or  5/17/73> 

BETWEEN  *'a  date>  AND  <another  date^ 

RE  <a  topic  word  in  quotation  marks>;  e g.,  RE  "energy" 

In  addition,  if  you  do  not  wish  to  see  the  heading  and  complete  text  of  the  entries 
you  have  specified,  you  may  use  any  of  the  foilowmg  restrictions: 

BY  FIRST  LINE 
BY  FIRST  <NUM>  LINES 
NO  HEADING 
NO  TEXT 


QUIT  --  closes  the  conference  for  you  and  returns  you  to  the  TENEX  executive  language. 
RESTART  --  takes  you  back  to  the  beginning  of  the  conference 

REVIEW  --  retrieves  and  displays  the  diccussion  entries  you  specify.  You  may  use  any 
of  the  options  listed  under  the  PUT  command  abnv_ 

SAVE  --  saves  the  transcript  from  the  activities  specified  by  placing  them  in  the  file  you 
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specify.  Do  not  specify  topic  numbers,  but  rather  the  activity  numbers  (which  all 
have  decimals  in  them).  For  example,  "save  i"  will  get  no  entries,  while  "save  1.1" 
will  get  all  entries  in  that  activity.  To  save  the  entire  conference,  type  "save  all". 

STATUS  --  prints  out  a roster  of  conference  participants  and  tells  which  activity  each  of 
the  active  participants  is  in. 

SUBMIT  — inserts  the  text  file  \/hich  you  specify.  This  file  becomes  the  next  entry  in 
the  current  activity.  It  has  , our  >'ame.  You  are  immediately  notified  of  the  number 
which  has  been  assigned  totne  submitted  entry.  (Do  not  submit  files  containing  line 
numbers.) 
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